home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / status < prev    next >
Encoding:
Text File  |  1996-09-07  |  3.0 KB  |  85 lines
  1.  
  2.  
  3.  
  4.      Status (V1.3, 2.x, 3.x internal) 
  5.  
  6.  
  7.      NAME
  8.           Status - Display the currently running CLI processes.
  9.  
  10.      SYNOPSIS
  11.           Status tasknum [FULL] [TCB] [CLI=ALL] [COMMAND=COM]
  12.  
  13.      DESCRIPTION
  14.             The most common use of Status is to find what 
  15.         background processes are still executing, this can be in 
  16.         preparation to sending them a signal with Break, or to 
  17.         find out if all your programs are completed before 
  18.         turning off the computer.  The various options to this 
  19.         command display information which may or may not be 
  20.         useful, depending on your needs.  The default behavior of 
  21.         Status is to display the CLI numbers and names of all 
  22.         currently active processes. You can get information on a 
  23.         specific process by typing Status <cli number>.
  24.  
  25.             You can also find out if a specific command is 
  26.         executing using the COMMAND keyword.  This can be useful 
  27.         in scripts, since if the command is NOT found, the WARN 
  28.         fail level will be set.  Otherwise, a 0 fail level is 
  29.         returned.  This is useful with shells that support 
  30.         command substitution to do things like send BREAK codes 
  31.         to processes.
  32.  
  33.      KEYWORDS
  34.  
  35.         taknum
  36.             The number of the task which STATus is to report on. 
  37.         If tasknum is not specified, all active tasks are 
  38.         reported.
  39.  
  40.         FULL
  41.             Displays all the information normally reported by 
  42.         STATUS if both the TCB and ALL were both specified. This 
  43.         keyword is completely optional.
  44.  
  45.         TCB
  46.             This displays all information concerning stack size, 
  47.         global vector size, and priority of all system tasks. 
  48.         This keyword is completely optional too.
  49.  
  50.         CLI or ALL
  51.             Specifying these keywords forces STATUS to report of 
  52.         the status of all the CLI tasks.  This is the same as 
  53.         running Status without any keywords. The CLI and ALL are 
  54.         interchangeable.
  55.  
  56.         COMMAND or COM
  57.             Added with 1.3, this prints the task number of the 
  58.         CLI from which the 'filename' program was run. This lets 
  59.         you send a break to a program using a script file. A 
  60.         return code of 5 (Warn)is returned if that command is not 
  61.         found.
  62.  
  63.      EXAMPLE
  64.           1. To find out everything about all executing
  65.           processes.
  66.  
  67.                Status FULL
  68.  
  69.           2. Here is an example using command substitution that
  70.              will send a break to the process executing the
  71.              ClockPtr command:
  72.  
  73.                   Break `Status Command ClockPtr`
  74.  
  75.             Note that the above assumes you are using 2.x/3.x's 
  76.         backtick function.  You might find it interesting to 
  77.         compare this example with the more complex one given for 
  78.         1.3: 
  79.  
  80.                   STATUS >ram:temp COMMAND ClockPtr
  81.                   BREAK <ram:temp >NIL: ?
  82.                   DELETE ram:temp
  83.  
  84.         Both of these accomplish the same thing!
  85.